home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / c64term4.zip / C64TERM.DOC < prev    next >
Text File  |  1991-01-05  |  52KB  |  1,771 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                            C64 Color Terminal Emulator
  23.  
  24.                               Copyright 1990 / 1991
  25.  
  26.                                  by Greg Pfountz
  27.  
  28.                                        V.4
  29.  
  30.                                  January 5, 1991
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.         
  58.         
  59.         C64 COLOR TERMINAL EMULATOR                                PAGE 1
  60.  
  61.                              * * * INTRODUCTION * * *
  62.  
  63.         Welcome to the wonderful world of Commodore's color/graphics
  64.         telecommunications!  C64 Color Terminal Emulator will allow many
  65.         IBM or compatible computer owners to join in on the fun that
  66.         Commodore users already enjoy.
  67.  
  68.         The Commodore 64 family of computers does not use the standard
  69.         ASCII character set.  It uses a customized character set known as
  70.         CBM ASCII.  This alternate character set allows changing
  71.         character colors and cursor movements simply by displaying a
  72.         specific character code.  For example, when the Commodore 64
  73.         prints a chr$(5), the cursor becomes white and all remaining
  74.         characters printed to the screen will be displayed white.  And
  75.         when you print chr$(145), the cursor moves up one line and all
  76.         remaining text will print from this position.  This method of
  77.         cursor positioning and setting screen colors is similar in
  78.         abilities to what ANSI can offer to an IBM or compatible, only
  79.         much simpler to use.
  80.  
  81.         This program will allow users of IBM and compatible personal
  82.         computer systems to call any Commodore 64 or Commodore 128
  83.         color/graphics bulletin board system and view/send any of the
  84.         color and graphics.  I know that there are several other terminal
  85.         emulators that offer similar abilities; it is my goal to produce
  86.         a terminal program that has more features and is easier to use. I
  87.         want to offer to any IBM or compatible user a terminal program
  88.         that:
  89.  
  90.            1) works properly on their system
  91.            2) does the best job possible of CBM ASCII emulation
  92.            3) is easy for the end user to learn and operate
  93.            4) offers the features we have all come to expect
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.         
  117.         
  118.         C64 COLOR TERMINAL EMULATOR                                PAGE 2
  119.  
  120.                         * * * HARDWARE REQUIREMENTS * * *
  121.  
  122.         C64 Color Terminal Emulator was written with Microsoft's Quick-C
  123.         (v2.5) and should run satisfactorily at 2400 baud even while
  124.         processing a script and logging to disk on the slowest of
  125.         computer systems.  On faster systems, the maximum baud rate is
  126.         110,000.  It is required that your system be using a CGA,
  127.         Hercules, EGA or VGA display type - although an MDA option
  128.         (without color of course) could be added later if demand warrants
  129.         it.  A color monitor is not required, but it definitely improves
  130.         the appearance of the display.  If you are a DESQview user, C64
  131.         Color Terminal Emulator will automatically detect your DESQview
  132.         environment and write directly to DESQview screen memory.  This
  133.         allows you to run C64 Color Terminal Emulator inside a small
  134.         window without any character bleed through and eliminates the
  135.         necessity to use BIOS screen writes or virtualize the screen (on
  136.         386 processors).
  137.  
  138.         C64 Color Terminal Emulator requires DOS 2.1 or greater and about
  139.         256K bytes free ram (after DOS and any TSRs are loaded) to
  140.         operate.  Additional memory will be required for any external
  141.         protocols or to shell out (either manually or via a script) and
  142.         run other programs.  On systems with only 200K of free ram, C64
  143.         Color Terminal Emulator may still operate properly but without
  144.         the screen review capabilities.  If at least 64K of expanded
  145.         memory is available, C64 Color Terminal Emulator will allocate
  146.         64K for the screen review buffer instead of using conventional
  147.         memory.  This can be helpful when running C64 Terminal Emulator
  148.         in a shell of another terminal program.
  149.  
  150.         Also required is a Hayes compatible modem with DCD (data carrier
  151.         detect) setup properly (eg. setup to be true only when the modem
  152.         is connected to a remote system).  On most 2400 baud modems, this
  153.         requires that the modem be configured with AT&C1&W.  On most 1200
  154.         baud modems, a switch will control DCD.  Refer to your modem's
  155.         manual for details.  The autodial routines will not operate if
  156.         DCD is configured incorrectly, but all other functions should
  157.         operate properly.  If when you select the autodialer and the
  158.         cursor jumps over the dial and manual selections, your DCD is not
  159.         setup correctly.  Another indication of an improperly setup DCD
  160.         is that the status line says ONLINE when you know you are not
  161.         connected to a BBS.
  162.  
  163.         Non-Hayes compatible modems may be made to work, but no
  164.         guarantees are made here.  If anyone has a unique modem and would
  165.         like help making it work, feel free to write me.  If it is
  166.         possible, I will do my best to make it work with C64 Color
  167.         Terminal Emulator.
  168.  
  169.         Standard COM ports 1 - 4 are supported as well as a user defined
  170.         COM port for those that have a non-standard modem/rs232 card.
  171.         Supported baud rates are 300-110,000.
  172.  
  173.         Due to the differences between the Commodore and IBM character
  174.         sets, not all Commodore characters have an exact IBM character
  175.         
  176.         
  177.         C64 COLOR TERMINAL EMULATOR                                PAGE 3
  178.         replacement.  And only the EGA and VGA display systems on the
  179.         IBMs allow using a redefined character set to allow emulating
  180.         these unique Commodore character codes.  So CGA and Hercules
  181.         users will not see all the graphic characters exactly as they
  182.         should - but most will be close.
  183.  
  184.         Also, the IBMs and compatibles allow 16 foreground colors and 8
  185.         background colors while in text mode.  Any combination of
  186.         foreground and background colors are allowed.  The IBM systems do
  187.         not have a specific reverse video mode.  The Commodore 64 has 16
  188.         colors any of which can be normal or reverse video and only one
  189.         of the 16 available colors at a time can be the background color.
  190.         Both computer systems have very good text color abilities, but
  191.         each are different enough that an exact emulation is not
  192.         possible.  The PC can only display 8 background colors (used to
  193.         emulate the reverse video mode on the Commodore 64) so not all
  194.         colors will be exact.  For example, a line of yellow text on the
  195.         Commodore 64 will show as a yellow text on the IBMs and
  196.         compatibles, but when the yellow line is reverse video on the
  197.         Commodore 64, it will display as black characters on a red
  198.         background on the IBM (there is not a yellow background color
  199.         available on the IBM systems).  I am sure that overall you will
  200.         find the emulation very good.
  201.  
  202.         C64 Color Terminal Emulator supports the use of a mouse to
  203.         navigate it's menus.  From terminal mode, press the left mouse
  204.         button to bring up the help screen.  Then move the mouse cursor
  205.         over the desired function (eg. Screen Review, Download, F1,
  206.         RvsOn, etc) and press the left mouse button again to select.
  207.         While dialing, the left button will initiate either a redial or
  208.         begin a pause for redial cycle.  Pressing the right mouse button
  209.         from terminal mode while a script is running or a capture log is
  210.         open, will cancel the script or close the capture log.  At all
  211.         other locations, the left mouse button will act like the enter
  212.         key and the right mouse button like the esc key.  And mouse
  213.         movements will respond like cursor keys (other then in terminal
  214.         mode).
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.         
  235.         
  236.         C64 COLOR TERMINAL EMULATOR                                PAGE 4
  237.                                 * * * FILES * * *
  238.  
  239.         The following files are contained in this archive:
  240.  
  241.          C64TERM.EXE  - C64 Color Terminal Emulator
  242.          C64TERM.DOC  - this file
  243.          C64TYPE.EXE  - displays Commodore files on screen
  244.                         uses the same output routines as C64TERM.EXE
  245.          CBM2ASCI.EXE - converts a CBM ASCII file to ASCII
  246.                         default output is STDOUT - can be redirected to
  247.                         a disk file or printer
  248.          LBR64.EXE    - dissolves Commodore .lbr files
  249.          AX.EXE       - dissolves Commodore .arc files (by Chris Smeets)
  250.          LISTCBM.EXE  - displays Commodore BASIC files (by Chris Smeets)
  251.  
  252.         The following file will be created automatically:
  253.          C64TERM.CFG  - config file for C64TERM.EXE
  254.                         contains your configuration, phone list, function
  255.                         keys, registration number, etc.
  256.  
  257.         The executable files should either be placed in a directory that
  258.         is in your path or create a batch file that will make the
  259.         directory where these files are stored the default directory.
  260.  
  261.         The C64TERM.CFG needs to be either in the default directory when
  262.         C64 Color Terminal Emulator is started or you need to assign the
  263.         environment variable C64TERM to point to where your C64TERM.CFG
  264.         is stored.  For example
  265.          SET C64TERM=C:\TERMINAL\
  266.         will tell C64 Color Terminal Emulator to look for its
  267.         configuration file in the C:\TERMINAL\ directory even if
  268.         C64TERM.EXE is located in another directory and/or your default
  269.         directory is not C:\TERMINAL\.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.         
  294.         
  295.         C64 COLOR TERMINAL EMULATOR                                PAGE 5
  296.  
  297.                                * * * STARTUP * * *
  298.  
  299.         C64 Color Terminal Emulator was designed to be started in 1 of 2
  300.         ways.  First is for it to be started from the command prompt by
  301.         typing:
  302.          C64TERM [SCRIPT] [/OPTIONS] [...]
  303.         It will initialize the modem and if applicable, automatically
  304.         execute SCRIPT.  This is the way most term programs are started.
  305.  
  306.         Alternatively, (and I feel will be the most popular) is to call
  307.         C64 Color Terminal Emulator from within another terminal program
  308.         (such as Telix, Procomm, Qmodem or any of the other popular
  309.         ANSI/ASCII terminal emulators for the MS DOS family of
  310.         computers).  With this mode of startup, you might be using the
  311.         autodialer of your ASCII terminal program to dial a series of
  312.         bulletin board numbers waiting for a connection on any one of
  313.         several systems.  If you get a connection on a Commodore
  314.         color/graphics system, a script from within the ASCII terminal
  315.         program would then execute through its system/dos/run command
  316.         C64TERM [SCRIPT] to start C64TERM and if SCRIPT automatically
  317.         execute SCRIPT.  C64 Color Terminal Emulator will not send any
  318.         modem initialize commands, nor will it attempt to initialize the
  319.         UART when started in this manner.  Instead it will query the UART
  320.         to determine its current baud rate and display that baud rate on
  321.         its own status line.  And then SCRIPT will take over and begin to
  322.         log you into the Commodore color/graphics system.
  323.  
  324.         The following script will load C64 Terminal Emulator from within
  325.         Telix and automatically start a script named DE.SCR:
  326.  
  327.             main() {
  328.                dos("c64term de",0);
  329.             }
  330.  
  331.         The following startup options are also available by typing them
  332.         after the program name:
  333.             /noems   - do not use EMS memory if available
  334.             /nomouse - do not use mouse drive if available
  335.             /bios    - use BIOS screen writes only
  336.             /snow    - use routines that eliminate snow on CGA screens
  337.             /help    - display a list of startup options
  338.  
  339.         Example:
  340.              C64TERM DE /NOEMS /NOMOUSE
  341.         will start C64 Color Terminal Emulator without using EMS memory
  342.         (if available) or a mouse (if available) and then start running
  343.         the script DE.
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.         
  353.         
  354.         C64 COLOR TERMINAL EMULATOR                                PAGE 6
  355.  
  356.                                 * * * SETUP * * *
  357.  
  358.         Setup is performed via a series of pop-up menus.  Initially the
  359.         Alt-Key sequence for SETUP is Alt-S.  One of the options from
  360.         within SETUP allows you to redefine the Alt-Key sequences
  361.         themselves.  If you should ever forget what sequence you defined
  362.         for SETUP, refer to the Help Screen.  This help screen will
  363.         reflect the current Alt-Key assignments.  Even the Alt-Key
  364.         sequence to pull up the Help Screen can be redefined.  If
  365.         necessary, refer to the status line at the bottom of the screen
  366.         for the current Alt-Key sequence to call up the help screen.
  367.  
  368.         The menu below indicates the options available in SETUP.
  369.  
  370.             ┌───────────────┐
  371.             │ Screen Colors │
  372.             │ Files/Paths   │
  373.             │ Function Keys │
  374.             │ Alt Keys      │
  375.             │ ASCII Pacing  │
  376.             │ Modem Init    │
  377.             │ Ext Protocol  │
  378.             │ Registration  │
  379.             └───────────────┘
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.         
  412.         
  413.         C64 COLOR TERMINAL EMULATOR                                PAGE 7
  414.  
  415.                             * * * SCREEN COLORS * * *
  416.  
  417.         The first option (Screen Colors) allows you to redefine any of
  418.         the menu and status line colors.  By default, the color choices
  419.         are light grey on a blue background (or black background if you
  420.         are using a black & white monitor).  Not the most interesting
  421.         color combination - but one that should be visible by all screen
  422.         types. This option allows each user to use whatever colors that
  423.         are best for your hardware and personal preferences.  When
  424.         selected, the following menu will appear.
  425.  
  426.             ┌───────────────────────────────────┐
  427.             │   F1 - Text Foreground Color      │
  428.             │   F2 - Text Background Color      │
  429.             │   F3 - Border Foreground Color    │
  430.             │   F4 - Border Background Color    │
  431.             │   F5 - Title Foreground Color     │
  432.             │   F6 - Title Background Color     │
  433.             │   F7 - Selected Foreground Color  │
  434.             │   F8 - Selected Background Color  │
  435.             │   F9 - Shadow Foreground Color    │
  436.             │  F10 - Shadow Background Color    │
  437.             │ SHF1 - Status Foreground Color    │
  438.             │ SHF2 - Status Background Color    │
  439.             │            Selected Text          │
  440.             └───────────────────────────────────┘
  441.  
  442.         Simply press the Function Key indicated to increment the desired
  443.         color.  The menu will immediately update to the new color.
  444.         Repeat selecting Function Key's until you find the combination
  445.         that best suits you and your hardware.  There are 16 possible
  446.         foreground colors and 8 possible background colors.  Press ESC
  447.         when you have selected the best possible color combination - the
  448.         new colors will begin being used immediately and automatically be
  449.         saved in the C64TERM.CFG file when you Exit C64 Color Terminal
  450.         Emulator.
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.         
  471.         
  472.         C64 COLOR TERMINAL EMULATOR                                PAGE 8
  473.  
  474.                              * * * FILES/PATHS * * *
  475.  
  476.         The second option on the SETUP menu (Files/Paths) allows you to
  477.         define where C64TERM will find its SCRIPT files as well as where
  478.         to upload files from and download files to on your system.  The
  479.         menu will look similar to the following.
  480.  
  481.             ┌──────────────────────┐
  482.             │  Download Path:A:\   │
  483.             │                      │
  484.             │  Upload Path:  A:\   │
  485.             │                      │
  486.             │  Script Path:  A:\   │
  487.             └──────────────────────┘
  488.  
  489.         Leave the field blank to use the current directory.
  490.  
  491.         In the case of the upload and download directories, the paths can
  492.         be overwritten during an upload or download simply by backspacing
  493.         over the path display and changing it as necessary.
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.         
  530.         
  531.         C64 COLOR TERMINAL EMULATOR                                PAGE 9
  532.  
  533.                             * * * FUNCTION KEYS * * *
  534.  
  535.         The third option on the SETUP menu (Function Keys) allows you to
  536.         pre-define up to 20 function keys.  Each function key can contain
  537.         up to 70 characters and when pressed, will send its contents at a
  538.         pace that is suitable for a Commodore 64 BBS.  The exact pace is
  539.         defined in the ASCII SEND option (discussed later).  Simply use
  540.         the cursor arrow keys to select the desired function key and type
  541.         the text you want to send.  Use the ~ character to send a
  542.         carriage return and type \### to send any other non-ASCII
  543.         character codes.
  544.  
  545.             ┌───────────────────────────────────────┐
  546.             │     F1                                │
  547.             │     F2                                │
  548.             │     F3                                │
  549.             │     F4                                │
  550.             │     F5                                │
  551.             │     F6                                │
  552.             │     F7                                │
  553.             │     F8                                │
  554.             │     F9                                │
  555.             │     F10                               │
  556.             │  SH F1                                │
  557.             │  SH F2                                │
  558.             │  SH F3                                │
  559.             │  SH F4                                │
  560.             │  SH F5                                │
  561.             │  SH F6                                │
  562.             │  SH F7                                │
  563.             │  SH F8                                │
  564.             │  SH F9                                │
  565.             │  SH F10                               │
  566.             └───────────────────────────────────────┘
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.         
  589.         
  590.         C64 COLOR TERMINAL EMULATOR                               PAGE 10
  591.  
  592.                                * * * ALT KEYS * * *
  593.  
  594.         The next option in SETUP (Alt Keys) allows you to redefine the
  595.         Alt-Key sequences for C64 Color Terminal Emulator.  This is handy
  596.         for those persons who are used to using a specific ASCII terminal
  597.         when calling other BBS systems and allows modifying C64 Color
  598.         Terminal Emulator to use the same Alt-Key sequences.  For
  599.         example, maybe the terminal program you are used to using uses
  600.         ALT-O for Setup Options and Alt-J for DOS (such as Telix), this
  601.         feature will allow you to modify C64 Color Terminal Emulator to
  602.         use the same Alt-Key sequences.  So instead of your having to
  603.         learn another terminal program, C64 Color Terminal Emulator can
  604.         be setup to operate similar to the terminal programs you
  605.         currently use.
  606.  
  607.         The following menu is what you will see when you select Alt Keys.
  608.         Be careful to not assign 2 functions to the same Alt-Key
  609.         sequence.
  610.  
  611.             ┌─────────────────────┐
  612.             │           Setup: S  │
  613.             │       Baud Rate: B  │
  614.             │    Clear Screen: C  │
  615.             │       Dos Shell: D  │
  616.             │  Execute Script: E  │
  617.             │      Log On/Off: L  │
  618.             │    Phone Dialer: P  │
  619.             │   Review Screen: R  │
  620.             │    Hangup Modem: H  │
  621.             │            Help: Z  │
  622.             │            Exit: X  │
  623.             │   Toggle Status: T  │
  624.             │    Toggle Width: W  │
  625.             └─────────────────────┘
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.         
  648.         
  649.         C64 COLOR TERMINAL EMULATOR                               PAGE 11
  650.  
  651.                               * * * ASCII SEND * * *
  652.  
  653.         The next option on the SETUP menu (ASCII Send) is where you will
  654.         define the character by character pacing as well as the line by
  655.         line pacing used by C64TERM when sending an ASCII file, text
  656.         assigned to a function key or text from within a script.  The
  657.         default is a 30 millisecond delay per character with a 500
  658.         millisecond delay at the end of each line.  These values should
  659.         work good when calling most Commodore systems.  Keep in mind that
  660.         these values have nothing what-so-ever to do with an Xmodem
  661.         Upload or Download which will always transfer at maximum speed.
  662.  
  663.             ┌───────────────────────────────────┐
  664.             │  Char Pacing (1/1000 secs):   30  │
  665.             │                                   │
  666.             │  Line Pacing (1/1000 secs):  500  │
  667.             └───────────────────────────────────┘
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.         
  707.         
  708.         C64 COLOR TERMINAL EMULATOR                               PAGE 12
  709.  
  710.                               * * * MODEM INIT * * *
  711.  
  712.         Next on the SETUP menu (Modem Init) is where you define an
  713.         initial string to send to your modem, an initial baud rate to use
  714.         and the desired COM port.  The modem init string and baud rate
  715.         will only be sent *IF* your system is not already detecting
  716.         carrier when C64 Color Terminal Emulator is started.  This allows
  717.         C64 Color Terminal Emulator to be easily called from within
  718.         another terminal program and instead of having to be concerned
  719.         with making sure the baud rate is correct and avoiding the
  720.         results of the sending the modem init string to the already
  721.         connected system, C64 Terminal Emulator just quietly starts up
  722.         and even 'learns' your current baud rate.  Below is the menu you
  723.         see when you select Modem Init.
  724.  
  725.             ┌────────────────────────────────┐
  726.             │       Modem init: ATS7=60S8=2~ │
  727.             │                                │
  728.             │        Baud rate: 2400         │
  729.             │                                │
  730.             │ COM port (1-4,U): 1            │
  731.             └────────────────────────────────┘
  732.  
  733.         Available COM ports are the standard COM ports 1 through 4 or U.
  734.  
  735.         If you enter a U, you will be prompted for a user defined COM
  736.         port IRQ number and base address.  Refer to your modem or RS232
  737.         interface documentation for this information.  Be warned that if
  738.         select an invalid IRQ or base address, you may crash your system;
  739.         possibly even corrupt data on your hard drive.  Do not define a
  740.         user defined COM port unless necessary and you know what you are
  741.         doing.
  742.  
  743.         If you change the COM port number, you may need to exit and
  744.         restart C64 Color Terminal Emulator before the newly configured
  745.         port can be used.
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.         
  766.         
  767.         C64 COLOR TERMINAL EMULATOR                               PAGE 13
  768.  
  769.                           * * * EXTERNAL PROTOCOL * * *
  770.  
  771.         Next on the SETUP menu is where you define any external
  772.         protocols.  An external protocol is a piece of software that is
  773.         written to be called in a shell of a terminal program and will
  774.         perform a file transfer.  A very popular external protocol is
  775.         DSZ.  It has the Xmodem, Xmodem/CRC, Xmodem/1K, Ymodem, and
  776.         several versions of Zmodem protocols.  There are also external
  777.         Punter protocols available (very popular with Commodore BBS's).
  778.  
  779.         C64 Color Terminal Emulator allows defining up to 9 external
  780.         protocols for download and 9 external protocols for uploads.
  781.         Each definition requires both a description of 15 chars or less
  782.         that will be displayed in the download menu when you press PGUP
  783.         or PGDN and a DOS command that will start the protocol if you
  784.         select that protocol.  You can either have the dos command call a
  785.         batch file or call the protocol directly.  If you need to pass to
  786.         the protocol the port number, baud rate or filename, put %P%, %B%
  787.         and/or %F% in the command at the appropriate places.  Example, to
  788.         start a protocol that requires its command to be:
  789.  
  790.           xp /b:1200 /c:1 filename
  791.  
  792.         you would setup your dos command as:
  793.  
  794.           xp /b:%b% /c:%p% %f%
  795.  
  796.         If the external protocol does not need a filename (either it asks
  797.         you directly or receives the filename directly from the BBS
  798.         (such as with multi-punter) do not use the %f% command and C64
  799.         Color Terminal Emulator will not bring up the filename selection
  800.         window.
  801.  
  802.         Note: %P% will not work if you have defined a user defined COM
  803.         port instead of selecting one of the standard COM ports 1 - 4.
  804.         In this case, you will have to hard code the necessary
  805.         information.
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.         
  825.         
  826.         C64 COLOR TERMINAL EMULATOR                               PAGE 14
  827.  
  828.                              * * * REGISTRATION * * *
  829.  
  830.         This is where you enter your registration number.  This
  831.         registration number can be found on the label of your C64 Color
  832.         Terminal Emulator diskette.
  833.  
  834.         As new updates are made available, simply download them from your
  835.         nearest bulletin board or communications service and enter your
  836.         registration number from your original disk.
  837.  
  838.         If you find that you like C64 Color Terminal Emulator and are
  839.         using it on a regular basis, please do register your copy.
  840.         Support the shareware authors that support your computer
  841.         hardware!
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.         
  884.         
  885.         C64 COLOR TERMINAL EMULATOR                               PAGE 15
  886.  
  887.                             * * * SCREEN REVIEW * * *
  888.  
  889.         This feature will allow you to review text that has recently
  890.         scrolled off the top of your computer's screen.  The reviewed
  891.         text will be redisplayed with full color and graphics.
  892.  
  893.         Press the HOME key to jump to the top of the review buffer, END
  894.         to jump to the end of the review buffer.  PgUp to move up 20
  895.         lines or PgDn down to move down 20 lines.  CrsrUp and CrsrDn will
  896.         move one line up and down, respectively.
  897.  
  898.         Unregistered users are limited to 50 lines in the screen review
  899.         buffer.  This should be suitable for evaluation purposes.
  900.         Registered owners will have all 400 lines available.
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.         
  943.         
  944.         C64 COLOR TERMINAL EMULATOR                               PAGE 16
  945.  
  946.                                 * * * DIALER * * *
  947.  
  948.         C64 Color Terminal Emulator has a built in dialer capable of
  949.         storing and dialing up to 50 separate numbers.  I personally feel
  950.         50 numbers is more than enough - but if anyone needs more than 50
  951.         just let me know how many you want and I will make sure our next
  952.         version will accommodate your needs.
  953.  
  954.         The dialer system is very easy to use.  Pressing the Alt-Key
  955.         sequence to activate the dialer brings up the dialer screen.
  956.         From here you can press D to select a number or numbers for
  957.         dialing, M to enter a number to manually dial, E to select a
  958.         number to add/edit, C to edit the dialer configuration
  959.         information or Q to quit back to terminal mode.
  960.  
  961.  
  962.                                  * * * DIAL * * *
  963.  
  964.         If you press D for dial, press the space bar to mark numbers to
  965.         be dialed, and when you have selected all the numbers, press
  966.         RETURN.  The system will dial each marked number one by one until
  967.         a connection is made.  After a connection is made and that call
  968.         is complete, if you select Dial again the remaining selections
  969.         will still be marked for dial.
  970.  
  971.  
  972.                                 * * * MANUAL * * *
  973.  
  974.         If you press M for manual, you will need to enter a phone number
  975.         to dial and the desired baud rate.  The system will dial and
  976.         redial that one number until a connection is made.
  977.  
  978.  
  979.                                  * * * EDIT * * *
  980.  
  981.         If you press E for Edit, use the up and down arrows to highlight
  982.         the number to add/edit and press enter.  Then you will be
  983.         prompted for the system name, phone number, baud rate and script
  984.         name.
  985.  
  986.  
  987.                                 * * * CONFIG * * *
  988.  
  989.         If you press C for Configure, you will need to enter your modems
  990.         dial command (ATDT if your phone line has touch tone service or
  991.         ATDP if your have rotary service), dial command suffix (normally
  992.         ~ for a carriage return), seconds to wait for carrier (45 - 90
  993.         seconds is normal (the system will automatically redial earlier
  994.         if your modem detects a busy line and notifies C64 Color Terminal
  995.         Emulator with a BUSY message), delay between redials, and whether
  996.         you want the system to automatically adjust baud rate to match
  997.         the remote system.
  998.  
  999.         The dial command prefix and suffix are user definable to allow
  1000.         support of different modem types as well as support of different
  1001.         
  1002.         
  1003.         C64 COLOR TERMINAL EMULATOR                               PAGE 17
  1004.         long distance services.  If your modem does not use AT command to
  1005.         dial - you may be able to enter your modems dial commands here.
  1006.         But more important is if you are in an area where you need to
  1007.         dial extra characters before your number (eg. dial 9 to get an
  1008.         outside line), you could define your dial command prefix as
  1009.         'ATDT9,' (for example).  And if you are dialing from an area
  1010.         where you need to charge the call to your phone credit card, you
  1011.         could put (for example) ',,,,,80055512121111~' as your modem
  1012.         suffix (enough commas to delay until you hear the tone then your
  1013.         credit card number followed by a ~ for the carriage return).
  1014.  
  1015.         The auto adjust baud rate feature of C64 Color Terminal Emulator
  1016.         reads the speed at which the modem has connected and adjust
  1017.         itself to match.  When a Hayes 1200 compatible modem connects to
  1018.         another modem, it can be programmed to respond with CONNECT or
  1019.         CONNECT 1200.  If the modem is a Hayes 2400 compatible modem, it
  1020.         can be programmed to respond with CONNECT, CONNECT 1200, or
  1021.         CONNECT 2400, depending on the speed of the modem on the other
  1022.         end.  This allows us to always dial our modems at their highest
  1023.         baud rate and if the modem answering is a slower type, C64 Color
  1024.         Terminal Emulator will read the modems response and adjust itself
  1025.         accordingly.  For a Hayes 1200 compatible modem to be able to
  1026.         respond with CONNECT 1200, you must first send it an ATX1
  1027.         command.  Some modems have a switch you can set to allow it to
  1028.         default to this setting.  And for those that do not, you can put
  1029.         an ATX1 in your modem init string in the Modem Init section of
  1030.         SETUP in C64 Color Terminal Emulator.  For a Hayes 2400
  1031.         compatible modem to be able to respond with CONNECT 2400, you
  1032.         must first send an ATX2 command.  Actually if your modem supports
  1033.         ATX4 (most newer modems now do), this will allow your modem to
  1034.         respond with BUSY, VOICE, CONNECT, CONNECT 1200, CONNECT 2400,
  1035.         and NO CARRIER and is the recommended setting for all 2400 baud
  1036.         modems.  Most Hayes 2400 compatible modems allow you to define
  1037.         your ATX? setting and store it in non-volatile memory using an
  1038.         AT&W command.  If you have a modem that will not save your ATX
  1039.         command in non-volatile memory, you can put it in your Modem Init
  1040.         section of SETUP in C64 Color Terminal Emulator.
  1041.  
  1042.         If your modem does not support the ATX extended response codes,
  1043.         make sure you put an N in the auto baud rate adjust field.  Also,
  1044.         a display of 300 baud when connected to a system that you know is
  1045.         1200 baud or higher is a good indication you need to put an N in
  1046.         this field.
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.         
  1061.         
  1062.         C64 COLOR TERMINAL EMULATOR                               PAGE 18
  1063.  
  1064.                            * * * SCRIPT COMMANDS * * *
  1065.  
  1066.         C64 Color Terminal Emulator has a simple built in script
  1067.         processor.  All script commands are case insensitive with one
  1068.         command per line allowed and a maximum line length of 80
  1069.         characters.  At any time you can abort an executing script by
  1070.         press the ESC key or by pressing the Execute Script Alt-Key
  1071.         sequence.
  1072.  
  1073.         Following is a list of all script commands:
  1074.  
  1075.  
  1076.         DELAY VALUE
  1077.  
  1078.             Will delay the script processor (but not the terminal
  1079.             emulator) for VALUE of 1/1000th's of a second.
  1080.  
  1081.             EXAMPLE:
  1082.  
  1083.                 delay 3000
  1084.  
  1085.             will force a delay of 3 seconds.
  1086.  
  1087.  
  1088.         WAITFOR TEXT
  1089.  
  1090.             Will delay the script processor (but not the terminal
  1091.             emulator) until TEXT is received.  TEXT may be multiple words
  1092.             and the comparison text is case insensitive.  TEXT should
  1093.             not be enclosed in quotes unless quotes will be received
  1094.             from the remote system.  The maximum length of text is 72
  1095.             chars.  Use the ~ to wait for a Carriage Return.
  1096.  
  1097.             EXAMPLE:
  1098.  
  1099.                 waitfor hit return
  1100.  
  1101.             will force a delay of the script processor until 'hit return'
  1102.             is received from the remote system.
  1103.  
  1104.  
  1105.         TIMEOUT VALUE
  1106.  
  1107.             This command will set the maximum amount of time that WAITFOR
  1108.             will wait for a text match.  A separate TIMEOUT should be defined
  1109.             immediately before each WAITFOR.  Failure to define a TIMEOUT
  1110.             will cause WAITFOR to wait indefinitely.
  1111.  
  1112.             EXAMPLE:
  1113.  
  1114.                 timeout 5000
  1115.                 waitfor hit return
  1116.  
  1117.             will force a delay of the script processor until 'hit return'
  1118.             is received from the remote system or 5 seconds has passed.
  1119.         
  1120.         
  1121.         C64 COLOR TERMINAL EMULATOR                               PAGE 19
  1122.         IFTIMEOUT COMMAND
  1123.  
  1124.             If a TIMEOUT command has terminated the previous WAITFOR
  1125.             command, the rest of the line behind IFTIMEOUT will be
  1126.             processed by the script processor.  Otherwise the processor
  1127.             will skip to the beginning of the next line.
  1128.  
  1129.             EXAMPLE:
  1130.  
  1131.                 :l1
  1132.                 timeout 5000
  1133.                 waitfor command
  1134.                 iftimeout send \016
  1135.                 iftimeout goto l1
  1136.  
  1137.             will wait for 'command' to be received from the remote system
  1138.             or if 5 seconds has passed, will send a control p and loop
  1139.             back to the :l1 label.
  1140.  
  1141.  
  1142.         SEND TEXT
  1143.  
  1144.             Will send TEXT at the character and line pacing speed as defined
  1145.             in ASCII Send.  Use the ~ to send a Carriage Return.
  1146.  
  1147.             EXAMPLE:
  1148.  
  1149.                 send 123~password~
  1150.  
  1151.             will send '123' followed by a new line and then 'password'
  1152.             followed by another new line.
  1153.  
  1154.  
  1155.         PRINT TEXT
  1156.  
  1157.             Will print TEXT to the screen followed by a Carriage Return.
  1158.  
  1159.             EXAMPLE:
  1160.  
  1161.                 print Sending MAIL.BBS
  1162.  
  1163.             Will display on your screen (not to the remote system)
  1164.             'Sending MAIL.BBS' followed by a carriage return.
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.         
  1179.         
  1180.         C64 COLOR TERMINAL EMULATOR                               PAGE 20
  1181.         SENDFILE FILENAME.EXT
  1182.  
  1183.             Will send an ascii file at the character and line pacing speed as
  1184.             defined in ASCII Send.  The file is expected to be in ASCII
  1185.             format and will be converted to CBM ASCII as it is sent.
  1186.  
  1187.             EXAMPLE:
  1188.  
  1189.                 sendfile user.msg
  1190.  
  1191.             Will open the file 'USER.MSG' and will send it one character
  1192.             at a time at the pace defined in SETUP.
  1193.  
  1194.  
  1195.         UPLOAD FILENAME.EXT
  1196.  
  1197.             Will send a file using the Xmodem/CRC protocol.  If the file does
  1198.             not exist, an error will print and the script will continue.  To
  1199.             write reliable scripts, use the IFEXIST command to determine if a
  1200.             file exists before attempting to send it.
  1201.  
  1202.             EXAMPLE:
  1203.  
  1204.                 upload mail.bbs
  1205.  
  1206.             will begin an xmodem file upload of MAIL.BBS to the remote
  1207.             system.
  1208.  
  1209.  
  1210.         DOWNLOAD FILENAME.EXT
  1211.  
  1212.             Will receive a file using the Xmodem/CRC protocol.  If filename
  1213.             already exists, you will be prompted if you want to replace the
  1214.             file or not.
  1215.  
  1216.             EXAMPLE:
  1217.  
  1218.                 download members.lst
  1219.  
  1220.             will begin an xmodem file download from the remote system to
  1221.             the MEMBERS.LST file on your system.
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.         
  1238.         
  1239.         C64 COLOR TERMINAL EMULATOR                               PAGE 21
  1240.         LOGOPEN FILENAME.EXT
  1241.  
  1242.             Will open FILENAME.EXT as a capture file and all incoming data
  1243.             will be saved to this file.  All captured data will be converted
  1244.             to ASCII as it is saved to disk.  If the capture file already
  1245.             exists, new data will be appended to the end of the file.
  1246.  
  1247.             EXAMPLE:
  1248.  
  1249.                 logopen messages.log
  1250.  
  1251.             will open MESSAGES.LOG and store every character received
  1252.             from the remote system into it after first converting each
  1253.             character from CBM ASCII to ASCII.
  1254.  
  1255.  
  1256.         LOGCLOSE
  1257.  
  1258.             Will close an open capture file.
  1259.  
  1260.             EXAMPLE:
  1261.  
  1262.                 logclose
  1263.  
  1264.             closes an open capture file.
  1265.  
  1266.  
  1267.         SHELL COMMAND PARAMETERS
  1268.  
  1269.             Will shell out to DOS and pass COMMAND PARAMETERS to COMMAND.COM.
  1270.             This is a handy way to delete files, rename files, etc.
  1271.  
  1272.             EXAMPLE:
  1273.  
  1274.                 shell del c:\temp\*.*
  1275.  
  1276.             will shell out to dos and del all files in c:\temp
  1277.  
  1278.  
  1279.         BAUD VALUE
  1280.  
  1281.             Will change baud rate to the value indicated by VALUE.
  1282.  
  1283.             EXAMPLE:
  1284.  
  1285.                 baud 1200
  1286.  
  1287.             will set the current baud rate to 1200.
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.         
  1297.         
  1298.         C64 COLOR TERMINAL EMULATOR                               PAGE 22
  1299.         GOTO LABEL
  1300.  
  1301.             Allows jumping to another place in the script file indicated by
  1302.             :LABEL.  For a line to be considered a label, it must be begin
  1303.             with a : and contain any combination of characters and numbers.
  1304.             Goto's and labels are case insensitive.  Labels can also be used
  1305.             for comments since the script processor skips all lines that
  1306.             begin with a : for purposes other than as a target of GOTO.
  1307.  
  1308.             EXAMPLE:
  1309.  
  1310.                 ifexist mail.msg goto sendmail
  1311.                 goto logoff
  1312.                 :sendmail
  1313.                 send f
  1314.                 delay 3000
  1315.                 sendfile mail.msg
  1316.                 send /s
  1317.                 waitfor command
  1318.                 :logoff
  1319.                 send o
  1320.                 delay 1000
  1321.                 send y
  1322.  
  1323.             will check to see if MAIL.MSG exists and if so, will goto the
  1324.             routine that posts the message onto the bbs.  If the file
  1325.             does not exist, the script goes to the :logoff line.
  1326.  
  1327.  
  1328.         SCRIPT FILENAME
  1329.  
  1330.             Allows chaining one script to another.  The currently running
  1331.             script will be terminated and the called script will start at the
  1332.             beginning.
  1333.  
  1334.             EXAMPLE:
  1335.  
  1336.                 send 123~password~
  1337.                 script color64
  1338.  
  1339.             will send the id followed by a carriage return, then the
  1340.             password followed by another carriage return then loads and
  1341.             executes COLOR64.SCR from the directory defined in setup for
  1342.             script files.  This is handy when you have one script file
  1343.             for a certain kind of BBS, you could create several small
  1344.             script files to send the different logon data then they all
  1345.             chain to the same script to execute code that is common to
  1346.             all the BBSs of that type.
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.         
  1356.         
  1357.         C64 COLOR TERMINAL EMULATOR                               PAGE 23
  1358.         IFEXIST FILENAME.EXT
  1359.  
  1360.             If a line begins with IFEXIST FILENAME.EXT, the following part
  1361.             of the line will only be executed if FILENAME.EXT exists.
  1362.  
  1363.             EXAMPLE:
  1364.  
  1365.                 ifexist mail.msg goto sendmail
  1366.  
  1367.             would only execute the 'goto sendmail' if the file MAIL.MSG
  1368.             exists in the current directory.
  1369.  
  1370.  
  1371.         Example Script
  1372.  
  1373.         An example of a script that will automatically log you onto a
  1374.         Color 64 BBS:
  1375.  
  1376.             timeout 5000
  1377.             waitfor hit return
  1378.             send ~
  1379.  
  1380.             timeout 5000
  1381.             waitfor (y/n)
  1382.             send Y
  1383.  
  1384.             timeout 10000
  1385.             waitfor ~>
  1386.             send ###~ (put your user number here)
  1387.  
  1388.             timeout 10000
  1389.             waitfor ~>
  1390.             send ********~ (put your password here)
  1391.  
  1392.         This script can be started in one of 3 ways.  If you are using
  1393.         the built in dialer, put the script name in the dialer
  1394.         configuration.  If you are using a dialer in another term program
  1395.         and running C64TERM as a script or in a shell, start C64TERM with
  1396.         the script name as the command parameter (ex. C64TERM BBSNAME).
  1397.         And finally you can start the script by pressing your Execute
  1398.         Script Alt-Key combination.
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.         
  1415.         
  1416.         C64 COLOR TERMINAL EMULATOR                               PAGE 24
  1417.  
  1418.                      * * * COMMODORE 64 CHARACTER CODES * * *
  1419.  
  1420.         The following are a few of the more popular Commodore character
  1421.         codes.  These codes can be used when programming function keys
  1422.         and scripts.
  1423.  
  1424.         CHR$    Result On Screen
  1425.  
  1426.            5    White
  1427.           17    Crsr Down
  1428.           18    Rvs On
  1429.           19    Home Crsr
  1430.           20    Delete
  1431.           28    Red
  1432.           29    Crsr Right
  1433.           30    Green
  1434.           31    Blue
  1435.          129    Orange
  1436.          145    Crsr Up
  1437.          146    Rvs Off
  1438.          147    Clr Scrn
  1439.          148    Insert Space
  1440.          149    Brown
  1441.          150    Lt Red
  1442.          151    Dark Grey
  1443.          152    Med Grey
  1444.          153    Lt Green
  1445.          154    Lt Blue
  1446.          155    Lt Grey
  1447.          156    Purple
  1448.          157    Crsr Left
  1449.          158    Yellow
  1450.          159    Cyan
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.         
  1474.         
  1475.         C64 COLOR TERMINAL EMULATOR                               PAGE 25
  1476.  
  1477.                            * * * COMMON PROBLEMS * * *
  1478.  
  1479.         PROBLEM: C64 Color Terminal Emulator does not send the modem init
  1480.         string when started.  Or C64 Color Terminal Emulator will not
  1481.         allow you to select DIAL or MANUAL from the dialer menu.
  1482.  
  1483.         SOLUTION: C64 Color Terminal Emulator requires that your modem's
  1484.         carrier detect circuits be working properly.  That is, the
  1485.         carrier detect signal is true only when you are actually
  1486.         connected to a remote system.  This signal must go false when you
  1487.         are disconnected.  If your modem is in internal 2400 baud modem,
  1488.         all you need to do is type AT&C1&W from terminal mode.  If your
  1489.         modem is an internal 1200 baud modem, look for a switch on the
  1490.         back of the modem that when set either ignores or forces true
  1491.         carrier detect or sets carrier detect to monitor or tracks the
  1492.         state of carrier from the remote modem and set this switch to
  1493.         track the state of carrier from the remote modem.  Finally if
  1494.         your modem is an external modem, in addition to the above
  1495.         suggestions, you will need to look at your modem cable.  It
  1496.         should have a wire that connects pin 8 from the modem to either
  1497.         pin 8 on a 25 pin rs232 connector or pin 9 on a 9 pin rs232
  1498.         connector.
  1499.  
  1500.  
  1501.         PROBLEM: When running inside a window in DESQview, the mouse
  1502.         cursor does not match up with the text in the window.
  1503.  
  1504.         SOLUTION: If you are using a 386 or higher processor, virtualize
  1505.         the screen.  If you are using a 286 or less, do not use a mouse
  1506.         inside a DESQview window.
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.         
  1533.         
  1534.         C64 COLOR TERMINAL EMULATOR                               PAGE 26
  1535.  
  1536.                               * * * SHAREWARE * * *
  1537.  
  1538.         C64 Color Terminal Emulator is being released as shareware.  This
  1539.         is not free software.  Shareware software gives you the
  1540.         opportunity to try this software before you spend any of your
  1541.         hard earned money.
  1542.  
  1543.         I spent many months developing and debugging C64 Color Terminal
  1544.         Emulator and will probably spend many more months improving it.
  1545.         If you find that this software does meet your needs, $20 is all
  1546.         that is required to register your copy.  In return, you will get
  1547.         the latest version and documentation on disk along with a
  1548.         registration number necessary to expand the scroll back buffer
  1549.         from 50 lines to 400 lines.
  1550.  
  1551.         Please register your copy!
  1552.  
  1553.            Mail to:                        For more information:
  1554.                Greg Pfountz                     BBS# - 703 466 2120
  1555.                14 Longdale Rd                   GEnie - COLOR64BBS
  1556.                Bristol, VA  24201
  1557.  
  1558.         Updates will always be available from me for free.  To get an
  1559.         update at anytime, send in a blank disk in a pre-addressed pre-
  1560.         stamped mailer or download the latest copy from my BBS or GEnie.
  1561.         If you prefer, I will supply the disk, postage and mailer and
  1562.         mail you the latest copy for $5.
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.         
  1592.         
  1593.         C64 COLOR TERMINAL EMULATOR                               PAGE 27
  1594.  
  1595.                            C64 Color Terminal Emulator
  1596.  
  1597.  
  1598.                                 Registration Form
  1599.  
  1600.  
  1601.  
  1602.            Name: ________________________________________________________
  1603.  
  1604.  
  1605.         Address: ________________________________________________________
  1606.  
  1607.  
  1608.            City: ___________________________  State: _____  Zip: ________
  1609.  
  1610.  
  1611.  
  1612.  
  1613.                                                                  Total
  1614.                                               QTY               Enclosed
  1615.  
  1616.  
  1617.         C64 Color Terminal Emulator         _______  x $20.00 = ________
  1618.  
  1619.  
  1620.                        Desired Disk Size (circle one):    5 1/4    3 1/2
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.         
  1651.         
  1652.         C64 COLOR TERMINAL EMULATOR                               PAGE 28
  1653.  
  1654.                               * * * Update History * * *
  1655.  
  1656.         09/23/90 V.1
  1657.  
  1658.         Beta Test Release
  1659.  
  1660.  
  1661.         10/01/90 V.1A
  1662.  
  1663.         Fixed COM4 incorrect base address problem
  1664.  
  1665.  
  1666.         10/02/90 V.1B
  1667.  
  1668.         Dos shell did not work on all systems.  Instead of shelling out
  1669.         with the contents of COMSPEC to execute, now I shell out with
  1670.         COMMAND as the program to execute.
  1671.  
  1672.  
  1673.         10/08/90 V.1C
  1674.  
  1675.         First public release
  1676.  
  1677.  
  1678.         10/24/90 V.1D
  1679.  
  1680.         Fixed 'Auto adjust baud rate' to work properly at 1200 baud.  On
  1681.         faster CPU's, the system was picking up NULLs between the
  1682.         characters of the connect message and confusing the program
  1683.         logic.  The system now strips out all but alpha/numeric
  1684.         characters when looking for the connect messages.
  1685.  
  1686.  
  1687.         11/25/90 V.2
  1688.  
  1689.         Cleaned up the low level communications routines, added a user
  1690.         definable communications port (irq and offset), added a screen
  1691.         review option, and added support for external protocols.
  1692.  
  1693.  
  1694.         11/26/90 V.2A
  1695.  
  1696.         Fixed an intermittent lockup problem after using screen review
  1697.         followed by a shell to DOS command.
  1698.  
  1699.  
  1700.         12/20/90 V.3
  1701.  
  1702.         Added code to open all files to allow shared read access with
  1703.         denied writes only for LAN and multitasking systems (requires
  1704.         DOS 3.0+ and SHARE.COM loaded).
  1705.  
  1706.         Added Alt/T to toggle the status line on and off (useful when the
  1707.         BBS requires all 25 lines of screen display available such as
  1708.         with some online color/graphic games).
  1709.         
  1710.         
  1711.         C64 COLOR TERMINAL EMULATOR                               PAGE 29
  1712.         Fixed intermittent system lockups from occurring after exiting
  1713.         C64 Color Terminal Emulator and eliminated transmit interrupts
  1714.         from going to intermittently going to sleep.
  1715.  
  1716.         Added code to minimize the amount of blank space in the review
  1717.         buffer by not saving any rows of the screen where the cursor has
  1718.         not been.
  1719.  
  1720.  
  1721.         01/05/91 V.4
  1722.  
  1723.         Added mouse support.
  1724.  
  1725.         Sped up character insert routine.
  1726.  
  1727.         Put in code to store numlock and capslock status in .cfg file.
  1728.  
  1729.         If emm memory is available, 64K will be used for the screen
  1730.         review buffer.
  1731.  
  1732.         Fixed a character conversion problem that was not displaying one
  1733.         of the graphic characters properly.
  1734.  
  1735.         C64TYPE.EXE updated to include the character conversion fix
  1736.         described above.
  1737.  
  1738.         Fixed a problem where lines longer than 80 cols line were
  1739.         confusing the screen review routines causing pieces of the screen
  1740.         to not be saved properly.
  1741.  
  1742.         Added /noems, /nomouse, /snow, /bios and /help command line
  1743.         switches.
  1744.  
  1745.         Added 40 column support for viewing c64 graphics that do not
  1746.         display properly on an 80 column screen.
  1747.  
  1748.         Changed screen review routines to minimize use of malloc,
  1749.         eliminating fragmented memory and the related problems that go
  1750.         with fragmented memory.
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.         
  1769.         
  1770.         C64 COLOR TERMINAL EMULATOR                               PAGE 30
  1771.